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METHOD FOR UPDATING AND PRESERVING DATA 
WHEN PERFORMING A SOFTWARE UPGRADE 

Field of the Invention 

[0001] The present invention relates to a method for updating data, and more 

particularly, a method for updating existing data used in software when the software has 
been updated and/or revised in such a manner that the format of the data it uses has 
changed. 

Background 

[0002] Software applications, such as a software system embedded in a device 

like a mailing machine, typically create, operate on and store data in a particular pre- 
determined data format. Such software applications are often updated and/or revised one 
or more times during the life of the software. Many times, the updates and/or revisions to 
the software involve a change or changes to the format of the data that may be utilized by 
the software. In such cases, old, existing data (created and stored before the update or 
revision) cannot, in its present form, be utilized by the updated and/or revised software 
because the updated and/or revised software can only utilize data that is in the current 
(new) data format. The old, existing data, however, is often critical to the user of the 
software. It is thus frequently necessary that the old, existing data be made useable by 
the updated and/or revised software. 

[0003] A number of prior art methods have been developed for making such old, 

existing data useable by an updated and/or revised software application. In one such 
method, a separate software utility is written and provided with the updated and/or 
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revised version of the software. The separate software utility is written for a specific 
existing data format (the format of the data used by the software prior to the update 
and/or revision) and a specific new data format (the data format of the updated and/or 
revised software) and is used to convert the old, existing user data from the existing data 
format to the new data format. Because such prior art software utilities are specific to 
particular old and new data formats, they must be written for each specific software 
update and/or revision, and may not be used generically for any update and/or revision 
that involves a change in data format. 

[0004] In another prior art method, the old, existing data is extracted and 

manually converted from a specific existing data format to a specific new data format. 
For example, the old, existing data may be exported to an Excel spreadsheet or the like, 
where it is modified to conform to the new data format. Once modified, the data may be 
imported by the updated and/or revised version of software for use thereby. This method, 
while allowing the old data to be used, is disadvantageous because it is labor intensive 
and requires specialized knowledge of the two particular data formats in question. 

Summary of the Invention 

[0005] The present invention relates to a method of converting data stored in a 

file from a first (e.g., old) format to a second (e.g., new) format. The file includes one or 
more records, with each record including one or more fields of one or more data 
elements. Each of the records is associated with a first data map corresponding to the 
first format and a second data map corresponding to the second format. The method 
includes accessing a selected record from the file, initializing a new record, and for each 
field of the selected record, using the first data map associated with the selected record 

{ioo25!26.i> Page 2 of 15 



F-780 Express Mail Label No.: EU475486295US 

and the second data map associated with the selected record to determine whether the 
field is present in the second format, and if the field is present in the second format, 
copying the one or more data elements of the field to the new record at a field location for 
the field that is set forth in the second data map that is associated with the selected record. 
These steps are repeated for each of the remaining records of the file until all of the 
records in the file have been updated. The data to be converted may further include data 
stored in one or more additional files having one or more records, each of the records 
having one or more fields having one or more data elements. Each of these records is 
associated with a first data map corresponding to the first format and a second data map 
corresponding to the second format. The method, in this embodiment, further comprises 
repeating the accessing, initializing, using, and repeating steps recited above for each of 
the additional files, where in each case the file being operated upon is one of the 
additional files. 

[0006] The using step of the present invention may further include issuing a 

warning of potential data loss if a first size of one or more data elements of the field in 
question as set forth in the first data map associated with the selected record is larger than 
a second size of the one or more data elements of the field as set forth in the second data 
map associated with the selected record. Preferably, the first data map and the second 
data map associated with the selected record include information relating to a field type 
length and a field length for each field in the selected record. The first and second size 
for each of the fields is based on the field type length and field length information for 
each field. In addition, the initializing step preferably involves initializing the new record 
in a temporary file, wherein the method further includes saving the temporary file as a 
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new file after each of the records have been updated. Alternatively, the method may 
further comprise overwriting the file being updated with the temporary file after all of the 
records have been updated. The new record is preferably initialized with one or more 
default values, such as zero values, and the new record is preferably in the second format. 
[0007] Therefore, it should now be apparent that the invention substantially 

achieves all of the above aspects and advantages. Additional aspects and advantages of 
the invention will be set forth in the description that follows, and in part will be obvious 
from the description, or may be learned by practice of the invention. Moreover, the 
aspects and advantages of the invention may be realized and obtained by means of the 
instrumentalities and combinations particularly pointed out in the appended claims. 

Description of the Drawings 

[0008] The accompanying drawings illustrate presently preferred embodiments of 

the invention, and together with the general description given above and the detailed 
description given below, serve to explain the principles of the invention. As shown 
throughout the drawings, like reference numerals designate like or corresponding parts. 
[0009] Figure 1 A is a representation of a data map for a record in an old, existing 

data format utilized by a software application prior to an update or revision; 
[00010] Figure IB is a representation of a data map for a record corresponding to 
the record shown in Figure 1 A in a new data format utilized by an updated and/or revised 
version of the software application; and 

[00011] Figure 2 is a flow diagram illustrating a method of updating and 
preserving data when performing a software upgrade according to the present invention. 
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Detailed Description of the Preferred Embodiments 



[00012] The present invention relates to a method of converting data from a first, 
old format that is no longer useable by an updated and/or revised software application to 
a second, new format used by the updated and/or revised software application. The 
method of the present invention has universal applicability, meaning it is not specific to 
any two particular data formats. 

[00013] The preferred embodiment of the present invention contemplates a 
software application wherein data is stored in one or more files, with each file containing 
one or more records of data. Each record in turn contains one or more (usually multiple) 
fields of data. In addition, each record has a format that follows one of one or more pre- 
determined types or formats supported by the software. The type or format of the record 
specifies the fields the record contains and the size and location of data in the record. 
Within each file, all of the records contained therein are of the same type or format, 
meaning they all have the same fields of data with the same size and data location 
characteristics. Thus, while there may be multiple record types and as a result different 
files may have records of different types, within each particular file all records are of the 
same type. Accordingly, each file may be classified and operated upon according to the 
type of record it contains. 

[00014] The present invention utilizes what are known as data maps to simplify, 
automate and make generic or universal the process of converting old, existing data in a 
first, old format (i.e., the records are in an old format) used and stored by a software 
application to a second, new format (z.e, the records are in a new format) that may be 
used by an updated and/or revised version of the software. A data map is a compilation 
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of information that represents and describes the format of a particular type of record, 
including the number of fields the record type has, the name of each field, and the data 
type, size, location and other characteristics of each field. Each record type supported 
and used by the software has its own data map, and as data formats change with updates 
and/or revisions to the software, the corresponding data maps change. Typically, the data 
maps are provided as separate files that are stored with the current version of the software 
application. As the software is updated and/or revised, new data maps are provided with 
the updated and/or revised version of the software. The data maps can be created, for 
example, utilizing a special software utility that is used when the software application is 
designed and developed. 

[00015] Figure 1A is a table that represents the data map, indicated by reference 
numeral 5, for an example record type I used in one or more files of an example software 
application. The example record type I shown in Figure 1A is, for illustrative purposes, 
used by the software prior to an update and/or revision (and thus is an old format). As 
will be appreciated, the example software application will likely have one or more 
additional record types, each having its own data map (not shown in the Figures), that 
may be used to store data in files. Figure IB is a table that represents the data map, 
indicated by reference number 10, for a corresponding example record type I used in one 
or more files of the example software application after it has been updated and/or revised. 
Thus, the example record type I shown in Figure IB is in a second data format which is a 
new data format used by the software after being updated and/or revised. As will be 
appreciated, each record type used by the software will preferably, to the extent a change 
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has occurred, have a new data map that represents the format used by the updated and/or 
revised software. 

[00016] As seen in Figures 1A and IB, data maps 5 and 10 each list all of the 
fields that are included in all records that are of record type I (both old and new format). 
In addition, for each listed field, other information relating to the field and the data stored 
therein is provided including: (1) field type, which identifies for the relevant 
programming language, such as C, the data type (from a set of specified data types) of the 
data to be stored in that field; (2) field type length, which identifies in bytes the size of 
each element of data that is stored in that field; (3) field length, which identifies the 
number of data elements stored in that field; (4) field location, which identifies the 
location in the record, in terms of ordered numbers of bytes, where the data in that field 
begins; and (5) aggregate item map, which, if applicable, provides information about a 
specifically created (non-standard) aggregate data type used for the field (in the data 
maps 5 and 10, all data types are standard so null values are provided for each aggregate 
item map location). Thus, data maps 5 and 10 provide detailed information about the 
data stored in any file that utilizes record type I (in both the old and new formats). 
[00017] Also, by comparing the old and new data maps, one can determine how 
the data format has changed. As can be seen in Figures 1A and IB, record type I has 
changed between the old format represented by data map 5 and the new format 
represented by data map 10 as follows: (1) the field named "SpeedCode" has changed 
from an "unsigned short" field type having a field type length of 2 to an "unsigned long" 
field type having a field type length of 4; (2) a new field named "AccountCode" has been 
added at field location 176; (3) the field named "Attributes" has been moved to field 
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location 218; (4) the field named "HostAccountID" has been moved to field location 220; 
and (5) the field named "Level" has been moved to field location 224. 
[00018] Figure 2 is a flow diagram that illustrates a method according to the 
present invention for updating and making useable old, existing files of data when a 
software application is updated and/or revised in a manner that changes the format of the 
data it may utilize. The method converts one or more files of the old, existing data that 
are in a first, old (no longer useable) format to one or more files of data in a second, new 
format that is useable by the updated and/or revised software. The method operates file 
by file to perform the conversion, and within each file it operates record by record to 
convert each record, using data map information for the appropriate record type, from the 
old format for that record type to the new format for that record type. 
[00019] Referring to Figure 2, the method begins at step 100 where the first file of 
a group of one or more files to be updated is obtained. The files to be updated are in the 
first, old format. Next, at step 105, a determination is made as to whether the file in 
question has a new data map associated with it, meaning that the format for the type of 
record included in that file has changed such that it now has a new data map that 
describes the format of the record type. If the answer is no, i.e., a new data map does not 
exist, that means that the file is no longer being used in the updated and/or revised 
application and thus no update of the file is required. In such a case, at step 110, a 
determination is made as to whether that file is the last file to be updated. If the answer is 
yes, then, at step 1 15, the update process is complete. If the answer is no, then, at step 
120, the next file in the group of files to be updated is obtained and the process returns to 
step 105. 
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[00020] If, at step 105, a determination is made that the file in question does 
indeed have a new data map, then, at step 125, both the old data map for the relevant 
record type and the new data map for the relevant record type are obtained from memory. 
The relevant record type is known based on the file in question, as each file contains 
records of one particular type. The software may store a table that maps each file to a 
record type (and thus a data map) to assist in this process. Next, at step 130, a 
determination is made as to whether the old data map and the new data map just obtained 
are the same. If the answer is yes, then that means there have been no relevant changes 
made to the data format for the records in that file, and the method returns to step 1 10 as 
no update is required. If, however, the answer at step 130 is no, meaning that the old data 
map and the new data map for the relevant record type are different, then the method 
proceeds to step 135. 

[00021] In step 135, the first record, which is an old record, in the file in question 
is obtained. As will be appreciated, this old record includes data in the old format as set 
forth in the old data map. Next, at step 140, a new record is initialized, preferably with 
zero default values in each location, in a temporary file. This temporary file will be used 
to construct a new file for the data to be updated. Next, as shown in step 145, 
information from the first field in the old record in question is obtained. At step 150, a 
determination is made as to whether the field in question from the old record is also 
present in the new record to be created. This determination is made by examining the 
new data map to determine whether it includes a field having a name that matches the 
field in question. If the answer at step 150 is no, then that means that the new format as 
reflected in the new data map no longer includes the field in question and, as a result, the 
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data contained in the field in question in the old record is discarded and not included in 
the new record. If, however, at step 150 it is determined that the field in question from 
the old record is also present in the new record format, then, at step 155, a determination 
is made for the field in question as to whether the size of the field data is the same 
between the old format as indicated by the old data map and the new format as indicated 
by the new data map. Preferably, referring to the examples shown in Figures 1A and IB, 
a determination is made as to whether the field type length and field length in the two 
formats (old and new) are the same. If, at step 155, it is determined that there has been a 
change in size, then, at step 160, a determination is made as to whether the new size is 
greater than or equal to the old size. Preferably, again referring to Figures 1A and IB, a 
determination is made as to whether the field type length and field length as indicated in 
the new data map are greater than or equal to the field type length and field length as 
indicated in the old data map. If the answer is no, as seen in step 165, a warning is issued 
that indicates that data may be lost as a result of the change in size for the record. In 
many applications, this may not be a problem due to the fact that the size allocated for the 
particular field may have been diminished intentionally in the new format because too 
much space was originally allocated in the old format. If this is the case, then data will 
likely not be lost. 

[00022] Next, referring to step 170, if the answer at step 155 is no, the answer at 
step 160 is yes, or after completion of step 165, if applicable, then the data in the field in 
question from the old record is moved from the old field location as indicated by the old 
data map to the new field location in the new record in the temporary file as indicated by 
the new data map. At step 175, a determination is then made as to whether the field just 
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operated upon was the last field in the old record. If the field just operated upon is not 
the last field in the old record currently in question, then, at step 180, the method 
proceeds by obtaining the information from the next field in the old record in question. 
Thereafter, the method returns to step 150 for continued processing. 
[00023] If the answer at step 175 is yes, then, at step 185, a determination is made 
as to whether the old record in question is the last record in the file in question. If the 
answer is yes, then that means that all of the fields and records in the file currently being 
updated have in fact been updated and, at step 190, the new record in the temporary file 
that has been built is saved as a new data file. Preferably, the new records in the 
temporary file are actually written over the old records in the data file being updated. 
Alternatively, the temporary file may be saved as a new file. The method then proceeds 
to step 110 to determine whether there are more files to be updated. If, however, a 
determination is made at step 185 that the record currently in question is not the last 
record in the file, then, at step 195 the next old record from the file in question is obtained 
and the method returns to step 140 for continued processing. 

[00024] As will be appreciated, the method will continue as indicated until each of 
the files in question have been considered and, if appropriate, updated on a record by 
record and a field by field basis using the old and new data maps. It will also be 
appreciated that, because in step 140 the new record in the temporary file is initialized 
with a default value or values such as zero, in the event that a new field is added to the 
record type in question (it was not part of the old format for the record type), that field in 
the new record will maintain that default value as there is no corresponding data in the 
old record to transfer. 
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[00025] While preferred embodiments of the invention have been described and 
illustrated above, it should be understood that these are exemplary of the invention and 
are not to be considered as limiting. Additions, deletions, substitutions, and other 
modifications can be made without departing from the spirit or scope of the present 
invention. Accordingly, the invention is not to be considered as limited by the foregoing 
description but is only limited by the scope of the appended claims. 
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